<?php

/**
 * 微信小程序API路由配置示例
 *
 * 使用方式：
 * 1. 将此文件内容添加到 route/api.php 或单独创建路由文件
 * 2. 在 config/route.php 中确保启用了路由
 */

use think\facade\Route;



/**
 * ============================================================
 * 接口说明文档
 * ============================================================
 *
 * 1. 微信登录接口
 *    POST /api/wechat/miniprogram/login
 *    参数：
 *      - code: 微信登录凭证（wx.login获取）
 *    返回：
 *      - session_id: 会话ID，用于后续接口调用
 *      - openid: 用户唯一标识
 *      - unionid: 用户在开放平台的唯一标识
 *
 * 2. 获取手机号接口
 *    POST /api/wechat/miniprogram/phone
 *    参数：
 *      - session_id: 登录接口返回的会话ID
 *      - code: 手机号获取凭证（getPhoneNumber回调获取）
 *    返回：
 *      - phone_number: 完整手机号
 *      - pure_phone_number: 纯手机号
 *      - country_code: 国家代码
 *
 * 3. 获取用户信息接口
 *    POST /api/wechat/miniprogram/userinfo
 *    参数：
 *      - session_id: 登录接口返回的会话ID
 *      - nick_name: 用户昵称
 *      - avatar_url: 用户头像
 *      - gender: 性别（0-未知，1-男，2-女）
 *      - country: 国家
 *      - province: 省份
 *      - city: 城市
 *    返回：
 *      - user_info: 用户信息对象
 *
 * 4. 一键授权登录接口（推荐使用）
 *    POST /api/wechat/miniprogram/quickauth
 *    参数：
 *      - code: 微信登录凭证
 *      - nick_name: 用户昵称（可选）
 *      - avatar_url: 用户头像（可选）
 *      - gender: 性别（可选）
 *    返回：
 *      - session_id: 会话ID
 *      - openid: 用户唯一标识
 *      - user_data: 完整的用户数据对象
 *
 * ============================================================
 * 小程序端调用示例
 * ============================================================
 *
 * // 一键授权登录（推荐）
 * wx.login({
 *   success: (res) => {
 *     // 获取用户信息
 *     wx.getUserProfile({
 *       desc: '用于完善会员资料',
 *       success: (userRes) => {
 *         // 调用后端接口
 *         wx.request({
 *           url: 'https://your-domain.com/api/wechat/miniprogram/quickauth',
 *           method: 'POST',
 *           data: {
 *             code: res.code,
 *             nick_name: userRes.userInfo.nickName,
 *             avatar_url: userRes.userInfo.avatarUrl,
 *             gender: userRes.userInfo.gender
 *           },
 *           success: (authRes) => {
 *             console.log(authRes.data);
 *             // 保存session_id到本地
 *             wx.setStorageSync('session_id', authRes.data.data.session_id);
 *           }
 *         });
 *       }
 *     });
 *   }
 * });
 *
 * // 获取手机号（需要用户点击按钮）
 * // wxml:
 * // <button open-type="getPhoneNumber" bindgetphonenumber="getPhoneNumber">获取手机号</button>
 *
 * // js:
 * getPhoneNumber(e) {
 *   if (e.detail.code) {
 *     wx.request({
 *       url: 'https://your-domain.com/api/wechat/miniprogram/phone',
 *       method: 'POST',
 *       data: {
 *         session_id: wx.getStorageSync('session_id'),
 *         code: e.detail.code
 *       },
 *       success: (res) => {
 *         console.log('手机号：', res.data.data.pure_phone_number);
 *       }
 *     });
 *   }
 * }
 */
